.. _ecmGn_SetupMotionEnvironmentFromFile:

ecmGn_SetupMotionEnvironmentFromFile
==========================================
------------------------------------------


SYNOPSIS
--------


.. code-block:: none

  t_success  ecmGn_SetupMotionEnvironmentFromFile(
    t_i32  NetID,
    char  szMotCfgFile,
    t_i32  *ErrCode
  )



DESCRIPTION
-----------


- XML 형식의 Motion Configuation 파일을 읽어와 모션관련 각종 초기값(속도, Unit Distance/Speed, Speed Pattern, Home 복귀 파라미터, 링카운터, 소프트웨어 리밋, 마스터/슬레이브 및 Motion IO 속성)을 설정합니다.


.. warning:: 이송 중 모션 환경설정을 수행하면 설정 내용에 따라 이미 이송 중인 모션에 영향을 줄 수 있습니다. 환경 설정 내용을 정확히 파악하고 있지 않다면 모션 환경 설정은 각 축이 정지되어 있는 상태에서 수행합니다.
  

PARAMETER
---------


- NetID : Network 번호

- szMotCfgFile : XML 형식의 Motion Configuration File 명(경로 포함)

- ErrCode : 이 매개 변수를 통하여 현재의 에러 코드를 반환합니다. 단, 이 매개 변수에 NULL을 전달하면 에러 코드를 반환하지 않습니다.




RETURN VALUE
------------


- 이 리턴값은 불 형(Boolean Type) 을 가지고 있습니다.



+-------+--------------------------------------+
| Value | Meaning                              |
+=======+======================================+
| 0     | 함수 수행에 실패하였음을 의미합니다. |
+-------+--------------------------------------+
| 1     | 함수 수행에 성공하였음을 의미합니다. |
+-------+--------------------------------------+